Skunkware 5/Skunkware 5.iso/man/cat.1/xkibitz.1

Text File | 1995-07-25 | 9KB | 199 lines

     XXXXKKKKIIIIBBBBIIIITTTTZZZZ((((1111))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((00006666 OOOOccccttttoooobbbbeeeerrrr 1111999999994444))))       XXXXKKKKIIIIBBBBIIIITTTTZZZZ((((1111))))



     NNNNAAAAMMMMEEEE
          xkibitz - allow multiple people to interact in an xterm

     SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
          xxxxkkkkiiiibbbbiiiittttzzzz [ _x_k_i_b_i_t_z-_a_r_g_s ] [ _p_r_o_g_r_a_m _p_r_o_g_r_a_m-_a_r_g_s... ]

     IIIINNNNTTTTRRRROOOODDDDUUUUCCCCTTTTIIIIOOOONNNN
          xxxxkkkkiiiibbbbiiiittttzzzz allows users in separate xterms to share one shell
          (or any program that runs in an xterm).  Uses include:

               o+   A novice user can ask an expert user for help.
                   Using xxxxkkkkiiiibbbbiiiittttzzzz, the expert can see what the user is
                   doing, and offer advice or show how to do it right.

               o+   By running xxxxkkkkiiiibbbbiiiittttzzzz and then starting a full-screen
                   editor, people may carry out a conversation,
                   retaining the ability to scroll backwards, save the
                   entire conversation, or even edit it while in
                   progress.

               o+   People can team up on games, document editing, or
                   other cooperative tasks where each person has
                   strengths and weaknesses that complement one
                   another.

               o+   If you want to have a large number of people do an
                   on-line code walk-through, you can sit two in front
                   of each workstation, and then connect them all
                   together while you everyone looks at code together
                   in the editor.

     UUUUSSSSAAAAGGGGEEEE
          To start xxxxkkkkiiiibbbbiiiittttzzzz, one user (the master) runs xkibitz with no
          arguments.

          xxxxkkkkiiiibbbbiiiittttzzzz starts a new shell (or another program, if given on
          the command line).  The user can interact normally with the
          shell, or upon entering an escape (described when xkibitz
          starts) can add users to the interaction.

          To add users, enter "+ display" where display is the X
          display name.  If there is no ":X.Y" in the display name,
          ":0.0" is assumed.  The master user must have permission to
          access each display.  Each display is assigned a tag - a
          small integer which can be used to reference the display.

          To show the current tags and displays, enter "=".

          To drop a display, enter "- tag" where tag is the display's
          tag according to the "=" command.

          To return to the shared shell, enter "return".  Then the



     Page 1                                          (printed 7/23/95)






     XXXXKKKKIIIIBBBBIIIITTTTZZZZ((((1111))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((00006666 OOOOccccttttoooobbbbeeeerrrr 1111999999994444))))       XXXXKKKKIIIIBBBBIIIITTTTZZZZ((((1111))))



          keystrokes of all users become the input of the shell.
          Similarly, all users receive the output from the shell.

          To terminate xxxxkkkkiiiibbbbiiiittttzzzz it suffices to terminate the shell
          itself.  For example, if any user types ^D (and the shell
          accepts this to be EOF), the shell terminates followed by
          xxxxkkkkiiiibbbbiiiittttzzzz.

          Normally, all characters are passed uninterpreted.  However,
          in the escape dialogue the user talks directly to the
          xxxxkkkkiiiibbbbiiiittttzzzz interpreter.  Any EEEExxxxppppeeeecccctttt(1) or TTTTccccllll(3) commands may
          also be given.  Also, job control may be used while in the
          interpreter, to, for example, suspend or restart xxxxkkkkiiiibbbbiiiittttzzzz.

          Various processes can produce various effects.  For example,
          you can emulate a multi-way write(1) session with the
          command:

               xkibitz sleep 1000000

     AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
          xxxxkkkkiiiibbbbiiiittttzzzz understands a few special arguments which should
          appear before the _p_r_o_g_r_a_m name (if given).  Each argument
          should be separated by whitespace.  If the arguments
          themselves takes arguments, these should also be separated
          by whitespace.

          ----eeeessssccccaaaappppeeee sets the escape character.  The default escape
          character is ^].

          ----ddddiiiissssppppllllaaaayyyy adds a display much like the "+" command.  Multiple
          -display flags can be given.  For example, to start up
          xkibitz with three additional displays:

               xkibitz -display mercury -display fox -display
          dragon:1.0


     CCCCAAAAVVVVEEEEAAAATTTTSSSS
          Due to limitations in both X and UNIX, resize propagation is
          weak.

          When the master user resizes the xterm, all the other xterms
          are logically resized. Unfortunately, xkibitz cannot force
          the physical xterm size to correspond with the logical xterm
          sizes.

          The other users are free to resize their xterm but their
          sizes are not propagated.  The master can check the logical
          sizes with the "=" command.

          Deducing the window size is a non-portable operation.  The



     Page 2                                          (printed 7/23/95)






     XXXXKKKKIIIIBBBBIIIITTTTZZZZ((((1111))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((00006666 OOOOccccttttoooobbbbeeeerrrr 1111999999994444))))       XXXXKKKKIIIIBBBBIIIITTTTZZZZ((((1111))))



          code is known to work for recent versions of SunOS, AIX,
          Unicos, and HPUX.  Send back mods if you add support for
          anything else.

     EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
          The environment variable SHELL is used to determine and
          start a shell, if no other program is given on the command
          line.

          If the environment variable DISPLAY is defined, its value is
          used for the display name of the xxxxkkkkiiiibbbbiiiittttzzzz master (the display
          with tag number 0). Otherwise this name remains empty.

          Additional arguments may be passed to new xterms through the
          environment variable XKIBITZ_XTERM_ARGS.  For example, to
          create xterms with a scrollbar and a green pointer cursor:

               XKIBITZ_XTERM_ARGS="-sb -ms green"
               export XKIBITZ_XTERM_ARGS

          (this is for the Bourne shell - use whatever syntax is
          appropriate for your favorite shell). Any option can be
          given that is valid for the xxxxtttteeeerrrrmmmm command, with the
          exception of ----ddddiiiissssppppllllaaaayyyy, ----ggggeeeeoooommmmeeeettttrrrryyyy and ----SSSS as those are set by
          xxxxkkkkiiiibbbbiiiittttzzzz.

     SSSSEEEEEEEE AAAALLLLSSSSOOOO
          TTTTccccllll(3), lllliiiibbbbeeeexxxxppppeeeecccctttt(3) kkkkiiiibbbbiiiittttzzzz(1)
          "_E_x_p_l_o_r_i_n_g _E_x_p_e_c_t: _A _T_c_l-_B_a_s_e_d _T_o_o_l_k_i_t _f_o_r _A_u_t_o_m_a_t_i_n_g
          _I_n_t_e_r_a_c_t_i_v_e _P_r_o_g_r_a_m_s" by Don Libes, O'Reilly and Associates,
          January 1995.
          "_k_i_b_i_t_z - _C_o_n_n_e_c_t_i_n_g _M_u_l_t_i_p_l_e _I_n_t_e_r_a_c_t_i_v_e _P_r_o_g_r_a_m_s
          _T_o_g_e_t_h_e_r", by Don Libes, Software - Practice & Experience,
          John Wiley & Sons, West Sussex, England, Vol. 23, No. 5,
          May, 1993.

     AAAAUUUUTTTTHHHHOOOORRRR
          Don Libes, National Institute of Standards and Technology

















     Page 3                                          (printed 7/23/95)